home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Technotools
/
Technotools (Chestnut CD-ROM)(1993).ISO
/
editors
/
oneach
/
editor.man
< prev
next >
Wrap
Text File
|
1987-07-06
|
36KB
|
928 lines
'ONE-EACH EDITORS'
Version 1.03
Users Guide
Written and compiled in
TURBO PROLOG* v1.1
(c) Copyright 1987
Brad Perkins
All Rights Reserved
*TURBO PROLOG is a trademark of Borland International
***** CONTENTS *****
INTRODUCTION ....................................................... 1
REQUIREMENTS ....................................................... 1
LIMITATIONS ....................................................... 1
GETTING STARTED .................................................... 2
Printing this users guide ..................................... 2
Hard Disk Systems ............................................. 2
Floppy Systems ................................................ 2
Starting One-Each ............................................. 2
THE MENU SYSTEM .................................................... 3
Edit .......................................................... 3
THE PRINT MENU ................................................ 3
Print Editor ............................................... 3
External File .............................................. 3
Headers .................................................... 3
Doublestrike ............................................... 3
Margin Indent .............................................. 3
THE FILES MENU ................................................ 4
Load text .................................................. 4
Saving Text ............................................. 4
Delete File ................................................ 4
File Directory ............................................. 4
Rename ..................................................... 4
Operating System ........................................... 4
Zap Editor ................................................. 4
View File .................................................. 4
Wild Card .................................................. 4
THE SETUP MENU ................................................ 5
Directories (path) ......................................... 5
Printer Port ............................................... 5
Save Setup ................................................. 5
QUIT .......................................................... 5
USING ONE-EACH ..................................................... 6
THE ONE-EACH EDITOR ................................................ 6
THE EDITOR FUNCTION KEYS ...................................... 6
F1 Help .................................................... 6
F2 Goto Line ............................................... 7
F3 Search .................................................. 7
F4 Substitute .............................................. 7
Block Functions(F5-F7) ..................................... 8
F8 External Edit ........................................... 8
F9 External Copy ........................................... 8
F10 End .................................................... 8
Escape Abort ............................................... 8
WORDSTAR COMPATIBLE COMMANDS ....................................... 9
THE SHAREWARE CONCEPT ............................................. 10
DISCLAIMER ........................................................ 10
REGISTRATION FORM ................................................. 11
DEALER REGISTRATION ............................................... 12
CUSTOMIZE FORM PAGE 1. ............................................ 13
COMMENT FORM ...................................................... 14
INTRODUCTION
'ONE-EACH EDITORS' Is a virtual screen editor for use by anyone
who wishes to create or modify existing text files. It's not a word-
processor but it can be used for simple letters and notes. One-Each
is especially useful to programmers because of the features included
specifically for programmers. Some of these features are as follows:
1: An auxillary editor window from which you may edit
or copy from an external file. This is actually part
of Turbo Prolog's built in editor.
2: Several file handling utilities.
a. Delete file
b. Rename file
c. Display directory
d. Change logged drive and directory
e. Jump to DOS (and return)
f. View file
g. Copy file
3: Printer support:
a. Print editor
b. Print external file
c. Select printer port
d. Page header on/off
4: User interface:
a. Pull down, pop up menus and windows
b. Editor status line
c. Menu and editor command line
d. Instant help windows from the editor
5: Last file autoload:
One-Each will automatically load the last
file saved from the previous session.
***** REQUIREMENTS *****
HARDWARE: IBM pc, xt, at or compatible with 256K ram memory,
and one floppy disk drive.
Epson or equivalent printer. 'ONE-EACH should work
with any ascii printer.
SOFTWARE: COMMAND.COM must reside in the same directory with
One-Each in order for the DOS shell (Operating
System) feature to work. The setup files should also
be in the same directory.
***** LIMITATIONS *****
As of this writing One-Each can handle ascii files no larger
than 64K. This is due to limits imposed by Turbo Prolog on its string
handling predicates.
Page 1.
***** GETTING STARTED *****
**************************************************************
* << IMPORTANT >> *
* *
* Make a backup copy of 'ONE-EACH' and store the original in *
* a safe place. *
**************************************************************
PRINTING THIS USERS GUIDE:
Go to the "Setup" menu and select the correct printer port,
then select "External file" from the "Print" menu. Type in
"EDITOR.MAN" at the prompt, ready your printer and press
return.
HARD DISK SYSTEM:
Create a directory called ONE-EACH (or whatever you wish).
Copy all of the files into the directory. Copy "COMMAND.COM"
from your DOS directory or DOS diskette into the One-Each
directory.
SINGE OR DOUBLE FLOPPY SYSTEMS:
The following files are not necessary for the operation of
One-Each on a color system:
MED.EXE
MONO.SYS
EDITOR.MAN
READ.ME
MAKE.EXE
The following files are not necessary for the operation of
One-Each on a mono (black and white or singe color) system:
ED.EXE
EDITOR.SYS
EDITOR.MAN
READ.ME
MAKE.EXE
You may remove these files from your "WORKING COPY" after
you have made a backup of the original diskette.
STARTING 'ONE-EACH':
If you have a color system type "ED" to start One-Each. If
you have a monochrome monitor type in "MED" to start One-Each.
One-Each immediatly loads "editor.sys" ("mono.sys" for monochrome
systems) and then "editor.dba". "Editor.sys" contains information
on the 'help' window and command line color attributes and is not
necessary in order for One-Each to function. "Editor.dba" on the
other hand must be present otherwise One-Each will not run.
Page 2.
***** THE MENU SYSTEM *****
One-Each contains a top line, pulldown and pop-up menu system.
These menu functions are arranged in a convienient, "use" priority order.
This may change in future versions depending on user feedback.
EDIT:
Takes you directly to the edit window and calls the edit status
and command lines. The status line indicates if auto indent and
the insert key is on or off. It also tracks the cursor position.
The command line indicates the Function key actions.
LEAVING THE EDITOR:
Pressing the escape key while in the editor aborts ANY
changes you have made in the editor and places the cursor in the
top line menu. Pressing the F10 key exits the editor and saves
any text changes into the file. You are given the option of saving
the file under a different name. Pressing the escape key at the
filename prompt aborts the editor and places the cursor in the top
line menu.
***** THE PRINT MENU *****
Pressing return at the "Print" option of the top line
menu will "Pull down" a sub-menu of print options. We will cover all
of these options in this section. The print driver should work with
any ascii printer. One-Each relies mostly on you already having your
printer correctly configured for your DOS system. The skip perforation
is "hard wired" for 11" page length.
NOTE:
Before attempting to print the editor or an external file make
certain you have selected the correct printer port from the "Setup"
menu.
PRINT EDITOR:
Outputs the current file text to the user selected printer port.
EXTERNAL FILE:
Allows the user to select an external file to be output
to the printer. If you press return at the first prompt you will
get a directory from which you can make a file selection. This will
not Affect any text that may be in the editor.
HEADERS:
Toggles page headers on and off. The status is indicated
in the bottom command line. When headers are on, a line of text
will be printed at the top of each page. The header line contains
the days' date, time, the file name, and the page number in the
right margin. The default is off.
DOUBLESTRIKE:
Toggles doublestrike mode on and off. The status is
indicated in the bottom command line. This will give darker
print but also doubles print time. The default is off.
MARGIN INDENT:
Moves the text to the right on the page during printing.
Page 3.
***** THE FILES MENU *****
LOAD TEXT:
Loads a text file into the editor window. A window pops
up with "File name (EXT)______". Hitting the return key at this
point calls a directory containing files with the .EXT extension.
You may select a file with the cursor keys and press return at
the highlighted file.
SAVING TEXT:
Pressing F10 from the editor overwrites the original file
with the contents of the editor. The original file is saved in a
file with the same name and a ".BAK" extension.
DELETE:
Calls a directory and allows the user to highlight a file
for deletion. Use this with caution. There are no "ARE YOU SURE"
prompts. It simply deletes the file.
FILE DIRECTORY:
Calls the file directory.
RENAME:
Calls a directory and allows the user to select a file
for renameing.
OPERATING SYSTEM:
Jumps to the DOS system. Typing "exit" returns to One-Each.
The DOS file 'COMMAND.COM' must reside in the same directory with
One-Each.
ZAP EDITOR:
Clears any text that may be in the editor and refreshes
the top line menu. There are no "ARE YOU SURE" prompts. It is
immediate and permanent.
VIEW FILE:
Allows user to view contents of an external file. This is
nondestructive to the editor contents.
WILD CARD (.*):
Resets the file extension default to the wildcard value for
the "Load File" function directory.
COPY FILE:
Allows the user to copy a file from one drive/directory
to another. First set the current directory from the setup menu
to the drive/directory you wish to copy from. Type in the file
name or select from the directory list. You will then be prompted
for the drive/directory to copy to. Another prompt will appear
with the file name. At this point you have the option of changing
the name or pressing return to keep the original name. Only text
files may be copied with this function.
Page 4.
***** SETUP MENU *****
The setup file "Editor.dba" contains a database that
One-Each uses in its initial start up. This database also keeps
a copy of the last file name "saved". The next time you run
One-each, it will automatically load the editor with the last file
you worked on.
DIRECTORIES:
Allows user to change logged drive or directory.
PRINTER PORT:
You may select from the centronics parallel (prn),
serial 1 (com1) or serial 2 (com2) printer ports. Select the
port your printer is connected to and then select the
"Save Setup" menu item. The next time One-Each is loaded
your printer will be the default.
SAVING THE SETUP FILE:
Quiting One-Each automatically saves the new con-
figuration file.
***** THE QUIT MENU *****
QUIT:
Saves the setup file and exits One-Each.
Page 5.
***** USING 'ONE-EACH' *****
This section may be used as a short "Do as you read" tutorial.
I recommend you load One-Each into your computor, load this manual
into One-Each, read the manual right off the screen and do the
actions as you go. In this way you can become very familiar with
One-Each in a matter of minutes.
***** THE 'ONE-EACH' EDITOR *****
THE EDITOR FUNCTION KEYS:
Placing the cursor at "edit" and pressing return (enter)
or pressing the 'e' key places the cursor into the editor window. The
editor status line at the top of the editor window will appear and the
command line at the very bottom of the screen will change. The command
line now indicates that the function keys are active and a short
description of what each F-key does. The funcion keys operate by pressing
the desired F-key, typing in the requested information, or in the case
of block functions, moving the cursor around to mark the appropriate
text. To execute the action press the F-key again (THE RETURN OR ENTER
KEY DOES NOT WORK).
REPEATING FUNCTIONS:
Multiple function key operations may be repeated by pressing
shift key/F-key combination. For example, after copying a block of text
(F5), moving the cursor to a different location, pressing shift-F5
will copy the text block again to the new location.
F1 HELP:
Pressing the F1 key (help) causes a little window to pop
up labeled "Main Menu" with a list of editor subjects. Pressing return
at the first menu item "help information" brings the help file from the
disk drive and places it in another window. Notice also that the command
line at the bottom of screen has changed to reflect functions for the
help window. You can use the cursor arrow keys to scroll through the
help window text. The F2 & F3 keys function the same as in the editor
window. Pressing Ctrl(control)-F10 zooms the window to full screen size.
It should be noted here that this also works in the editor window. The
shift-F10 combination brings up another command line with instuctions on
moving and resizing the help window. This function does not work in the
editor window. Press Esc(escape) or F10 to exit the help window. If you
are at the main help menu you must press Esc to exit.
Now would be a good time to bring up the main help menu and
explore the rest of the help functions. The sub-menus will actually
execute the assigned function for you. The escape key will always abort
these functions if you change your mind.
Page 6.
F2 GOTO LINE:
While in the editor the status line at the top of the
editor window keeps track of cursor position by line and column
number. If you move the cursor up the screen you will see the
line number decrease. Moving the cursor to the right increases
col position. Line 1 - column 1 does not necessarily begin at
the first line of text. It does begin at the very first line
and column of the editor. Pressing F2 allows you jump to any
line number as long as it is within the Text boundaries. In other
words if you have a short file that ends on editor line number
42 you cannot jump to line 600.
User action: press F2 key
Editor response: F2: goto line:_
User action: type in '25' (or any line number)
User action: press F2 key
Editor response: places cursor at line 25
F3 SEARCH:
This function allows the user to search for the first
occurrence of a text string. The string may be a single character,
word, or string of words. The search begins at the current
position of the cursor and works forward. Any occurrences of the
search string behind the cursor will not be found.
User action: press F3 key
Editor response: F3: Search text, text:_
User action: Type in string you wish to find
User action: Press F3 key
Editor response: Moves cursor to first matching string
User action: Press Shift-F3 combination
Editor response: Moves cursor to next matching string
F4 SUBSTITUTE:
Allows you to replace any or all occurrences of a string
with another string. This function first asks for the string
that you wish to replace and then asks for the new string value.
You have the choice of local (visable screen area) or global
replacement. Global begins at the current cursor position and
works down to the end of the text. If you wish to replace every
occurrence of a string it's a good idea to move the cursor to the
very top (beginning) of the text. You are then asked if you wish
a prompt at each string to be replaced. If not One-Each will
replace every occurance of the string without stopping.
User action: Press F4 key
Editor response: F4: Replace Text, Old Text:_
User action: Type in text you wish to replace
User action: Press F4 key
Editor response: F4: Replace Text, Old Text:<Text> New Text:_
User action: Type in replacement text
User action: Press F4 key
Editor response: F4: Global/Local replace (g/l):
User action: Type in 'g' for global or 'l' for local
User action: Press F4 key
Page 7.
******BLOCK FUNCTIONS *****
BLOCK FUNCTIONS:
One-Each includes the three common block functions.
Block copy, Block move and Block delete. You may mark "Blocks"
or portions of text for copying, moving or deletion. You simply
place the cursor at the beginning of the text you wish to move,
copy or delete, and press the corresponding F-key. You then move
the cursor across the line or down the screen to mark whole
lines or paragraphs of text. The text attribute changes as you
move and mark the blocks. When you finish marking your text then
press the appropriate function key again. In the case of Block
Move and Block Copy you move the cursor to the position you wish
the text to be moved or copied to then press the function key once
more and you are done. For Block Delete you press F7, mark the
text press F7 again and the text is gone.
OOPS, OH-NO, & AH-@#$%^&!:
Some pointers on errors are in order. Always save your
work frequently. I save mine at about every page I type in. I
also save right before taking a break. This way I always have a
file that is nearly up to date when :
a: The electricity goes out
b: I just accidently deleted 43 pages of text
c: I take a break and the cat takes a nap on
the keyboard.
Another thing to do when you scramble the contents
of the editor is to press the escape key to abort any changes
you have made in the session.
F8:EXTEDIT:
Calls the external file editor. Pressing F8 causes
another editor window to be created so you can edit another file
this auxillary editor works just like the main editor. The small
edit window may be zoomed to full size by pressing the Ctrl F10
combination.
F9:EXTCOPY:
Works just like F6 except it allows you to mark and copy
text into the main editor from an external file.
F10:END
Pressing F10 saves the editor contents to the current
drive and directory, exits the editor and places the cursor into
the top line menu system.
ESC:ABORT (From the editor)
Aborts and exits the editor and "undoes" any changes you
have made in the CURRENT edit session.
Page 8.
***** WORDSTAR COMPATIBLE COMMANDS *****
============================
WORDSTAR PC
CURSOR MOVEMENTS: COMMAND KEY
Character left Ctrl-S
Character right Ctrl-D
Word left Ctrl-A Ctrl -
Word right Ctrl-F Ctrl -
Line up Ctrl-E
Line down Ctrl-X
Page up Ctrl-R PgUp
Page down Ctrl-C PgDn
To left on line Ctrl-Q-S Home
To right on line Ctrl-Q-D End
To top of page Ctrl-Q-R Ctrl - Home
To bottom of page Ctrl-Q-X Ctrl - End
To top of file Ctrl-Q-R Ctrl - PgUp
To end of file Ctrl-Q-C Ctrl - PgDn
To beginning of block Ctrl-Q-B
To end of block Ctrl-Q-K
To last cursor position Ctrl-Q-P
INSERT & DELETE COMMAND KEY
Insert mode on/off Ctrl-V Ins
Insert line Ctrl-N
Delete line Ctrl-Y
Delete to end of line Ctrl-Q-Y
Delete right word Ctrl-T
Delete char under cursor Ctrl-G Del
Delete left character Ctrl-H
BLOCK COMMANDS COMMAND KEY
Mark block begin Ctrl-K-B F7
Mark block end Ctrl-K-K F8
Hide/display block Ctrl-K-H
Copy block Ctrl-K-C
Move block Ctrl-K-V
Delete block Ctrl-K-Y
Read block from disk Ctrl-K-R
Write block to disk Ctrl-K-W
Print block Ctrl-K-P
MISC. COMMANDS COMMAND KEY
Tab Ctrl-I
Repeat last find/replace Ctrl-L
Find Ctrl-Q-F
Find & replace Ctrl-Q-A
Auto tab on/off Ctrl-Q-I
Page 9.
***** THE SHAREWARE CONCEPT *****
Shareware is a means of distributing a software product. the product
is passed around and shared by individuals, BBS's, users groups and so
on. The concept places much trust in you, to be honest and pay for the
product once you have tried it and decided to keep it.
There are many shareware products that exceed comparable
commercial packages in both quality and usefulness. One of the greatest
benifits is the difference in cost. This difference is in the hundreds
of dollars in savings to you, depending on the product. But why does the
commercial product cost so much? The resources required in development
time, research and dedication are no less for the shareware product.
The most popular answer is that the large software companies must spend
billions in marketing, distribution and advertising. I do not agree that
this is the primary reason for inflated software prices. In recent years
software piracy has stripped these companies of much more than advertising
costs. In other words when you see someone illegally copy a software
product you must pay for his copy the next time you purchase a program.
Other shareware authors and myself are offering quality
products at extremely reasonable prices. If our efforts are not rewarded
with your support, then all of us will have lost. We will stop producing
and you will have to purchase your software from the large companies.
I believe most of you have high personal integrety. If I
did not believe that, I would not have produced One-Each for you. If you
purchase this product I will reward you with the next enhancement to One-
Each. You will also recieve a lot of admiration from me.
'ONE-EACH' is a shareware product. It is not free. The registration
fee is not optional. It is required beyond a reasonable "test" period
not to exceed 30 days. If after that period you feel that this product
does not meet your needs then please pass it on to someone else so that
they may try it.
********************************************************************
DISCLAIMER
********************************************************************
'ONE-EACH' and its associated files and documentation
are distributed without any expressed or implied
warranty of any kind. The author, supplier or distributor
shall not be liable for errors contained herein or for
incidental or consequential damages in connection with
the furnishing, peformance, use or misuse of these
materials.
Page 10.
********************************************************************
REGISTRATION FORM
********************************************************************
Your name:___________________________________________________
Street address:______________________________________
City, state, Zip:______________________________________
Your company name:___________________________________________
Street address:______________________________________
City, state, Zip:______________________________________
******* Quantity and dealer discounts available *******
See Dealer Registration Form
(_) Enclosed is my check/money order for the minimum registration
fee of $20.00. This entitles me to use 'ONE-EACH' on one (1)
computor at any given time. I will also recieve the next
enhancement to 'ONE-EACH'. California residents add 6% sales
tax.
(_) I wish to purchase the source code to 'ONE-EACH' to modify
for my own personal use. I understand I'm not to sell or
distribute the source code or any modified versions of 'ONE-
EACH'. Enclosed is $75.00 in check or money order.
PLEASE MAKE CHECKS PAYABLE TO :
Brad Perkins
250 touchstone Pl. #80
West Sacramento, CA 95691
Page 11.
**********************************************************************
DEALERS, DISTRIBUTORS, CORPS AND COMPANYS
**********************************************************************
If you wish to be a distributor of 'ONE-EACH' please fill out
the following registration. Distributors are required to pay
the initial registration fee of $20.00 and then only $15.00 Per
copy thereafter. Every sixth copy therafter is free to the dealer
distributor. It's the dealers responsibility to make certain that
the customer gets registered for tech support reasons. Please
send the original registation (with the payment) and make certain
that the customer knows how to contact me for support. Companies,
schools, government agencies may be their own dealers and follow
the same guidelines as stated above. For A $50.00 one time fee
(This includes the initial registration fee!!) you may also have
your distribution copy customized with your company name and phone
number or whatever across the top of the editor window where the
'ONE-EACH' logo normally resides. You may then distribute as many
of these copies as you wish using the dealer/distributor guidelines
above. It's a business card your customer is not likely to throw away.
Individual users are also invited to have their copy customized.
See the customize form.
(_) Yes I wish to be a dealer/distributor of One-Each.
Enclosed is $20.00 check or money order.
(_) Yes I wish to be a dealer/distributor of One-Each.
Enclosed is $50.00 check or money order and the
customize form. Please mail my custom copy to the
address below.
Name/Company:_______________________________________________________
Street Address:_____________________________________________________
City/state/zip:_____________________________________________________
Mail Payment To:
Brad Perkins
250 Touchstone Pl. #80
West Sacramento, Ca. 95691
<<NOTE>> Money orders ensure immediate turnaround. Personal checks
must await bank clearance.
Page 12.
**********************************************************************
CUSTOMIZE FORM
**********************************************************************
You may have the One Each editor window (the largest window
directly below the menu window) Title changed to your Company
name, slogan or whatever. Exceptions are the following:
1. Profanity
2. Comments, statements or Jokes that could
be construed as derogatory to any particular
race, class or religious group.
3. Any other comment, statment or slogan that
the author feels is degraded or lacking in
good Taste.
Your text is limited to 72 characters (including spaces), and
limited to standard IBM ascii characters that can be TYPED from the
keyboard. All text will be centered on the screen unless you specify
otherwise. Please type your text exactly as you wish it to appear on
the screen if possible, otherwise print very clearly. Make it clear
which characters are upper and lower case. Make certain your monitor
supports all of the characters you have selected.
Please fill out the following text field or make some copies
in case of errors.
1 2 3 4 5 6 7
123456789012345678901234567890123456789012345678901234567890123456789012
(________________________________________________________________________)
You will be sent both a color and monochrome version.
Customizing beyond what is on this form may cost more or may
not be feasable at all. For further customizing please write your
requests addressed to me with a phone number, name and time I may
contact you.
Page 13.
********************************************************************
USER COMMENT FORM
********************************************************************
<< THIS FORM MUST BE FILLED OUT WITHIN 30 DAYS OF REGISTERING >>
Please make any comments/suggestions not covered on this form
on the back or on another piece of paper.
User name:(not required)__________________________________________
Address _________________________________________________________
_________________________________________________________
_________________________________________________________
Date:_________________
-------------------------------------------------------------------
How often do you use One Each?
-------------------------------------------------------------------
What do you like about it?
-------------------------------------------------------------------
What do you dislike about it?
-------------------------------------------------------------------
How would you like it changed? (added, deleted, rearranged...).
-------------------------------------------------------------------
Which features are missing?
-------------------------------------------------------------------
Which features are useless?
-------------------------------------------------------------------
Is the documentation adequate?
-------------------------------------------------------------------
SEND TO:
Brad Perkins
250 Touchstone Pl. #80
West Sacramento, Ca 95691
Page 14.